		    BIKLOG3    V 1.2
********************************************************
*        For the Psion Series 3a and Series 3c.        *
********************************************************

(Copyright,  Jaap Lamris. November 1999)

INTRODUCTION
============

BIKLOG3 is a program made for bicyclists who like to keep
track of their bicycle rides during time. It is not meant
to be used during the ride as a cycle computer but as an
extension of it to store the cycle computer data and as
a tool to analyse the bicycle rides over time.

This program was my first major attempt at programming in
OPL. It was completely developed on my Series 3a with the
aid of the S3a emulator. I have tried to make the program
to be user friendly as far as possible, and have released
it after a long period of using it myself (during more
than a year).

This program is freeware, not because I don't need the
additional income or fancy the merits of this program, -
I spent a large amount of time and effort in creating and
debugging this program -, but charging for something I wrote
as a hobby and for fun is not my style. Further by making it
freeware (or better said postcardware, see the section
REGISTERING) I will not be forced to spent considerable time
in maintaining and supporting it just for the sake of getting
a small additional income. That doesn't mean that I will not
support it anymore. As an user of BIKLOG3 myself and as a
perfectionist by nature I will keep improving the program and
supporting any users of it. Another reason to release it as
freeware are some bad experiences in the past with shareware
(PSION and PC) programs for which I paid the registration,
after which the author did not support it any more, released
it as freeware or kept charging for updates despite his
earlier promises... .


REQUIREMENTS
============
Below is a file list with file sizes in bytes.

BIKLOG3.OPA -  21.0 kb    the application file
BIKE.INI    -  217        the default configuration file
BIKLOG3.RSC -  3.2  kb    the help file

optional:
bik97.ODB   -  8.2 kb     example database
bik97.INI   -  217        configuration file for example

BIKLOG3.TXT -  9.7 kb     this file

A minimal installation only requires "BIKLOG3.OPA" and "bike.ini".
A minimal installation means that no online help is
available.



INSTALLATION
============
Below is a list if files supplied in the distribution ZIP
file (The file biklog12.ZIP) and the directories
they should be placed in.

M:\APP\biklog3.OPA             Main application file.

M:\APP\biklog\biklog3.RSC       BIKLOG help file.
M:\APP\biklog\bike.ini          configuration file

Optionally:
M:\APP\biklog\bik97.odb          example database
M:\APP\biklog\bik97.ini          example configuration file


Alternatively you may install BIKLOG3 on any other drive
(drive A or B if you have an SSD.  BIKLOG3.OPA does not
have to be on the same drive as it's support files
(BIKE.ini and BIKLOG3.RSC) as long as you preserve
the correct directory structure, see above.
It is recommended not to place the *.odb and
*.ini files on a SSD drive, since they will be regularly be
updated.

For a minimal installation all you really need is the
file "BIKLOG3.OPA", but it is much more user friendly
with it's support files. If you are short of memory space,
just use the main OPA file, and skip the next section of
this text.

To install, unzip the file BIKLOG12.ZIP, the directory stucture is
retained in the file, so all the files are placed correctly if you
unzip it from your PC to the Psion, or directly on your Psion.
If you are moving the files manually from your PC, see the list of
directories, above.



INSTALLING BIKLOG3 ON THE SYSTEM SCREEN


To install BIKLOG3 on the system screen,
press PSION-I and select "BIKLOG3.OPA".



USAGE
=====

Most of the information you may need on how to use
BIKLOG3 is included on the on-line help.

If you do not install the online help here is a
description of all hot-key presses (All keys require
the Psion key to be held down, if the Shift key is
also required the letter will be upper case, otherwise
they will be lower case.)

o    Open a file
     - Always required, except when creating a new file. Enter
	 filename or use TAB or cursor to cycle through existing
	 files

n    Create a new file
     - After entering the name of the new file, you will be asked
	 for entering the names of up to four bicycles in your
	 household, and the type of bicycle rides you want to tag
	 to your rides (like commute, training, race, clubride).
	 Maximal five ride definitions are possible.

c    Close the current file
     - Only needed if you want to switch to another database file.

D    Delete a file

S    Sort current file
     - This will sort the records according to ascending date.
	 The plotting option assumes that the records are sorted by date!
	 If not you will get strange effects.

a    Add a record
     - Here you enter the date, bicycle name, bicycle ride type, distance,
	 time or average speed and a short descriptions (max. xx characters)
	 of the ride. By default the current date and the values of the last
	 entered record will be entered. You may choose to enter average speed
	 or time. Either one is sufficient.

s    scan records
     - All the records will be listed line by line. Use the cursor up, down,
	 and the PgUp or PgDn keys to move or scroll up or down, respectively.
	 HOME or END will move to the first or last record. ESC will exit the
	 scan mode, while HELP will invoke a listing of possible actions. The
	 left or right cursor keys will cycle through a long or shortened
	 version of the record text. (with or without the memo).

A    Alter a record

e    Erase a record

f    Find a string in the records
     -Use this option to find a string in the memo field of one or more records

p    Plot the (cum.) distances per bicycle or ride type
     -You will be prompted to enter starting and ending date of the time period,
	and the time unit along the x-axis (day, week or months). By default the
	starting date will be January 1th of the year of the first record,
	and the ending date will be the current date. Cumulative distance plots
	will be presented for each of the available bicycles (with more than 0 km)
	in the database plus all bicycles together. Use the up and down cursor
	keys to cycle through the plots, ESC will return to the menu, while
	HELP will lists the available actions.

P    Preferences settings
     -use this option to customise the bicycle names, and ride definitions.

?    Info on program

h    Help function

I    Statistical description of rides
     -Four tables will show you some common statistics (# of rides, cumulative
	and mean distances and duration for each bicycle and ride type in the
	database, absolute and relative to the total bike rides.

x    Exit

I do recommend that you use the online help, at least until
you become familiar BIKLOG3.


ACKNOWLEDGEMENTS
================

Thanks to Jezar for providing the Help generator, Neil K Bee (neil@bee.net)
for the use of one of his icons, and all other PSION programmers, especially
Steve Litchfield and Al Richey with their RMREVENT program, who gave me
examples of goord working programs.



REGISTRATION
============

WHY REGISTER ?

Although BIKLOG3 is freeware, I would be very happy if you let me know that
you are going to use my programme. First of all to satisfy my curiosity, after
putting numerous hours and effort in writing and debugging this program.
Secondly it will encourage me to continue further with this program and
extend it if you indicate a need for this. Thirdly I will be able to keep
you informed on next releases of BIKLOG3, if you registrate it by me.


HOW DO I REGISTER ?
Preferably you can send your name, adress and/or Email adres
by Email to:

Jaap Lameris
lamerisj@hotmail.com

Else you can send a postcard to:

Jaap Lameris
Richel 10
8303 KX EMMELOORD
Netherlands.

Please include in your registration note,  the version number, you got,
your postal adress and Email adress.

Additional information on BIKLOG3 will be also available on my homepage:

http://Jaap_Lameris.tripod.com/mypsion.htm


DISCLAIMER
==========
Use this software at your own risk. I will not be held
responsible for any loss of data and/or any damage caused
to users or hardware caused by this software.



COPYRIGHT AND CONDITIONS
========================
I reserve copyright on this material, any reproduction in
part or whole is strictly prohibited. Additionally,
reverse translation of any of files included in the file
"BIKLOG12.ZIP" is strictly prohibited.

You are permitted to distribute the file "biklog12.ZIP",
as widely as you see fit, under one condition. That
condition being; That the file is not in any way altered,
and is sent on in an unchanged state.



FEEDBACK
========
If you have any comments or suggestions for me I would be
pleased to hear from you ! You can mail me at the above
address or you can email me at these email addresses;

		 lamerisj@hotmail.com
			  or
		   lameris-molhoek@hetnet.nl

Now get on and start bicycling !!!


HISTORY
=======
Version 1.2 (Nov. '99):
Minor bugs solved. After each operation the main display returns.
Now named Biklog3 due to new version for the Series called Biklog5.

Version 1.1 (Feb. '99):
Better events scheduling applied based on
RMREVENT code. Extended help text.

Version 1.0 (Jan. '99):
Original release.



